home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / network / daemons / dns / bind-4.9 / bind-4 / usr / man / man5 / resolver.5
Encoding:
Text File  |  1995-08-04  |  6.2 KB  |  199 lines
  1.  
  2.  
  3.  
  4. RESOLVER(5)                    11,                    RESOLVER(5)
  5.  
  6.  
  7. NNAAMMEE
  8.        resolver - resolver configuration file
  9.  
  10. SSYYNNOOPPSSIISS
  11.        /etc/resolv.conf
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        The  _r_e_s_o_l_v_e_r  is  a  set  of  routines  in  the C library
  15.        (_r_e_s_o_l_v(3)) that provide access  to  the  Internet  Domain
  16.        Name  System.   The  resolver  configuration file contains
  17.        information that is read  by  the  resolver  routines  the
  18.        first  time  they  are  invoked by a process.  The file is
  19.        designed to be human readable and contains a list of  key-
  20.        words  with  values that provide various types of resolver
  21.        information.
  22.  
  23.        On a normally configured system this file  should  not  be
  24.        necessary.   The only name server to be queried will be on
  25.        the local machine, the domain name is determined from  the
  26.        host  name, and the domain search path is constructed from
  27.        the domain name.
  28.  
  29.        The different configuration options are:
  30.  
  31.        nnaammeesseerrvveerr
  32.               Internet address (in dot notation) of a name server
  33.               that  the resolver should query.  Up to MAXNS (cur-
  34.               rently 3) name servers may be listed, one per  key-
  35.               word.   If there are multiple servers, the resolver
  36.               library queries them in the order  listed.   If  no
  37.               nnaammeesseerrvveerr  entries  are present, the default is to
  38.               use the name server on  the  local  machine.   (The
  39.               algorithm  used is to try a name server, and if the
  40.               query times out, try the next, until  out  of  name
  41.               servers,  then  repeat  trying all the name servers
  42.               until a maximum number of retries are made).
  43.  
  44.        ddoommaaiinn Local domain name.  Most queries for  names  within
  45.               this  domain  can  use  short names relative to the
  46.               local domain.  If no ddoommaaiinn entry is  present,  the
  47.               domain  is  determined  from  the  local  host name
  48.               returned by  _g_e_t_h_o_s_t_n_a_m_e(2);  the  domain  part  is
  49.               taken   to  be  everything  after  the  first  `.'.
  50.               Finally, if the host name does not contain a domain
  51.               part, the root domain is assumed.
  52.  
  53.        sseeaarrcchh Search  list for host-name lookup.  The search list
  54.               is normally determined from the local domain  name;
  55.               by default, it contains only the local domain name.
  56.               This may be changed by listing the  desired  domain
  57.               search  path  following  the  _s_e_a_r_c_h  keyword  with
  58.               spaces or tabs separating the names.  Most resolver
  59.               queries  will  be attempted using each component of
  60.               the search path in turn until  a  match  is  found.
  61.  
  62.  
  63.  
  64. November                                                        1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RESOLVER(5)                    11,                    RESOLVER(5)
  71.  
  72.  
  73.               Note  that this process may be slow and will gener-
  74.               ate a lot of network traffic if the servers for the
  75.               listed domains are not local, and that queries will
  76.               time out if no server is available for one  of  the
  77.               domains.
  78.  
  79.               The search list is currently limited to six domains
  80.               with a total of 256 characters.
  81.  
  82.        ssoorrttlliisstt
  83.               Sortlist allows addresses returned by gethostbyname
  84.               to  be  sorted.   A  sortlist  is  specified  by IP
  85.               address netmask pairs. The netmask is optional  and
  86.               defaults  to the natural netmask of the net. The IP
  87.               address and optional network pairs are seperated by
  88.               slashes. Up to 10 pairs may be specified.
  89.  
  90.               e.g.      sortlist      130.155.160.0/255.255.240.0
  91.               130.155.0.0
  92.  
  93.        ooppttiioonnss
  94.               Options allows certain internal resolver  variables
  95.               to be modified.  The syntax is
  96.  
  97.               ooppttiioonnss _o_p_t_i_o_n _._._.
  98.  
  99.               where _o_p_t_i_o_n is one of the following:
  100.  
  101.               ddeebbuugg -- sets RES_DEBUG in _res.options.
  102.  
  103.               nnddoottss::_n  -- sets a threshold for the number of dots
  104.               which must appear in a name given to rreess__qquueerryy (see
  105.               _r_e_s_o_l_v_e_r(3))  before an _i_n_i_t_i_a_l _a_b_s_o_l_u_t_e _q_u_e_r_y will
  106.               be made.  The default for _n is ``1'', meaning  that
  107.               if  there  are any dots in a name, the name will be
  108.               tried first as an absolute name before  any  _s_e_a_r_c_h
  109.               _l_i_s_t elements are appended to it.
  110.  
  111.        The _d_o_m_a_i_n and _s_e_a_r_c_h keywords are mutually exclusive.  If
  112.        more than one instance of these keywords is  present,  the
  113.        last instance wins.
  114.  
  115.        The  _s_e_a_r_c_h  keyword of a system's _r_e_s_o_l_v_._c_o_n_f file can be
  116.        overridden on a per-process basis by setting the  environ-
  117.        ment variable ``LOCALDOMAIN'' to a space-separated list of
  118.        search domains.
  119.  
  120.        The _o_p_t_i_o_n_s keyword of a system's _r_e_s_o_l_v_._c_o_n_f file can  be
  121.        amended  on a per-process basis by setting the environment
  122.        variable ``RES_OPTIONS''  to  a  space-separated  list  of
  123.        resolver options as explained above under ooppttiioonnss.
  124.  
  125.        The  keyword  and  value must appear on a single line, and
  126.        the keyword (e.g. nnaammeesseerrvveerr) must start  the  line.   The
  127.  
  128.  
  129.  
  130. November                                                        2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RESOLVER(5)                    11,                    RESOLVER(5)
  137.  
  138.  
  139.        value follows the keyword, separated by white space.
  140.  
  141. FFIILLEESS
  142.        _/_e_t_c_/_r_e_s_o_l_v_._c_o_n_f
  143.  
  144. SSEEEE AALLSSOO
  145.        gethostbyname(3), resolver(3), hostname(7), named(8)
  146.        Name Server Operations Guide for BIND
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. November                                                        3
  197.  
  198.  
  199.